Self Service - Loss Prevention
This document explains the purpose and usage of the Loss Prevention services for developers and professional services colleagues. These services help determine and execute basket audits for self-service checkouts, contributing to loss prevention efforts. We handle the outcome processing internally to adjust customer trust levels where applicable.
Overview
The Loss Prevention services comprise two main components:
Basket Audit Evaluation: This service determines whether a basket should be audited based on various risk factors and pre-defined rules. It analyzes the contents of a self-service basket and makes a decision on whether an audit is necessary.
Basket Audit Service: This service executes the audit, if deemed necessary by the evaluation service. This involves comparing the scanned items with the items reported in the basket. The results of the audit are then processed to determine any discrepancies.
Data & Event Consumption
Data and events generated by the Loss Prevention services can be consumed in three ways:
Directly from Pub/Sub: For Extenda GCP projects, real-time data can be consumed directly from Pub/Sub. This provides the most immediate access to audit events and decisions. This method is suitable for real-time dashboards and alerting systems. Consult the relevant Pub/Sub documentation for topic names and schemas.
Persisted Audit Service: Audit data is persisted, allowing for historical analysis and reporting. This method is suitable for non-real-time use cases like trend analysis, performance evaluation, and compliance reporting. Details about accessing the persisted audit data will be provided separately.
SSA Service (Aggregated): Lightly aggregated data is available through the SSA (Self Service Application) service. This data can be accessed via:
- SSA UI: Provides a user interface within the SSA application for viewing aggregated audit information. This allows for easy access to key metrics and trends.
- SSD External Events: Aggregated data is also exposed as SSD (Self Service Data) external events, enabling integration with external systems. This allows for seamless integration with existing reporting and analytics platforms.
Integration & Usage
Developers can leverage these services to enhance loss prevention strategies in self-service environments. The flexible data access options cater to various integration scenarios and reporting needs. Professional services colleagues can utilize the provided data and interfaces to configure and monitor the Loss Prevention system effectively.
Further Information
- Basket Audit Determination API: developer.hiiretail.com/api/lossprevention-basketauditdetermination-api - This API allows you to submit basket information for real-time audit determination.
- Basket Audit API: developer.hiiretail.com/api/lossprevention-basketaudit-api - This API is used to manage and execute basket audits.
- Trust Level API: developer.hiiretail.com/api/lossprevention-trustlevel-api - This API provides access to customer trust level information.
- Persisted Audits API: developer.hiiretail.com/api/lossprevention-persistedaudits-api - This API allows access to the persisted audit data for historical analysis.
- Customer Profile API: developer.hiiretail.com/api/lossprevention-customerprofile-api - This API provides access to customer profile information relevant to loss prevention.
- Self-Service Analytics API: developer.hiiretail.com/api/lossprevention-selfserviceanalytics-api - This API provides aggregated analytical data related to self-service transactions.
- Architecture Overview: github.com/extenda/selfservice-lossprevention-common/blob/master/docs/selfservicelossprevention/architecture.md - Provides a detailed overview of the Loss Prevention system architecture.
Specific documentation and schemas for each data access method (Pub/Sub, persisted service, SSA service) are available separately. Refer to those resources for detailed implementation guidance. Please contact the development team for any further questions or clarification.